home *** CD-ROM | disk | FTP | other *** search
/ .net 2000 August / NET74.ISO / pc / Software / JavaApplet / AnfyMacBeta1.sea / Anfy for Macintosh / anjavapp / bump / anfybump.txt < prev    next >
Encoding:
Text File  |  1999-07-05  |  6.9 KB  |  151 lines  |  [TEXT/ttxt]
  1.  
  2.          Anfy BumpMap - Copyright (C) by Fabio Ciucci 1997-99
  3.  
  4.  
  5. This applet shows a lightsource over a "bumpy" surface which casts shadow
  6. over a selected screen image, which can be the same image as the bumpy map.
  7.  
  8. This applet is based on original code by Martin Zettergren that is used 
  9. under the licence.
  10.  
  11. The transparent image sun.gif is a courtesy of Lone Star Posse Prod. Inc.
  12.  
  13. The applet can use any picture in any size and it can optionally have a
  14. separate bump-image, which must be the same size as the screen picture. 
  15.  
  16. ***********************************************************************
  17.  
  18. NECESSARY FILES.
  19.  
  20. Together with a screen image and an optional bump map image, you need to
  21. upload the following files: 
  22.  
  23. anfybump.class
  24. Lware.class
  25. anfy.class
  26.  
  27. Plus, anfybump.jar for speedy loading on recent browsers.
  28.  
  29. **********************************************************************
  30.  
  31. EXAMPLE.
  32.  
  33. Insert the <applet> tag in your html document as follows to add this applet
  34. to your page (Comments after the ";" symbol are code descriptions and
  35. acceptable min/max values. They are not part of the applet language):
  36.  
  37.  
  38. <applet archive="anfybump.jar" code=anfybump.class width="256" height="256">
  39. <param name="credits" value="Applet by Fabio Ciucci (www.anfyteam.com)">
  40. <param name="regcode" value="NO">          ; Registration code (if you have it)
  41. <param name="reglink" value="NO">          ; Optional URL link when the applet
  42.                                            is "clicked".
  43. <param name="regnewframe" value="YES">     ; Reglink opened in new frame?
  44. <param name="regframename" value="_blank"> ; Name of new frame for reglink
  45. <param name="statusmsg" value="Bumpmap applet">      ; Statusbar message
  46. <param name="res" value="1">              ; resolution (1-8)
  47. <param name="picture" value="Symb256.jpg">; Screen image
  48. <param name="bump" value="NO">            ; Optional bump map image
  49. <param name="bump_height" value="1">      ; Bump Height
  50. <param name="angle_x" value="3">         ; Light x-dir movement    
  51. <param name="angle_y" value="4">         ; Light y-dir movement
  52. <param name="lightsize" value="9">       ; size of lightsource
  53. <param name="lightpower" value=95>       ; Light power (1..100)
  54. <param name="lightmin" value=10>         ; Light min power (1..511)
  55. <param name="lightmax" value=500>        ; Light max power (1..511)
  56. <param name="interactive" value="YES">   ; Interaction ("ON" .. "OFF")
  57. <param name="overimg" value="NO">        ; Optional image over applet
  58. <param name="overimgX" value="0">        ; Over image X offset
  59. <param name="overimgY" value="0">        ; Over image Y offset
  60. <param name="memdelay" value="1000">     ; Memory deallocation delay
  61. <param name="priority" value="3">        ; Task priority (1..10)
  62. <param name="MinSYNC" value="10">        ; Min. milliseconds/frame for sync
  63. Sorry, your browser doesn't support Java.; Message for no java browsers
  64. </applet>                                ; End of applet tag
  65.  
  66.  
  67. ***************************************************************
  68.  
  69. PARAMETER DESCRIPTIONS.
  70.  
  71. The following instructions describe how to change parameters:
  72.  
  73. Attempting to change the credits parameter will disable the applet.
  74.  
  75. To activate the reg parameters read the shareware registration notes.
  76. In the "regcode" parameter, place the registration code you
  77. purchased from the author. If the code is correct and the applet is run from
  78. the registered domain name, you can use "link" parameters to link to a URL
  79. when the applet is "clicked".
  80.  
  81. If you set "regnewframe" to "YES", you can specify a specific frame location
  82. for the reglink:
  83.  
  84. "_blank"  : To load the link in a new blank unnamed browser window.
  85. "_self"   : To load the link into the same window the applet occupies.
  86. "_parent" : To load the link into the immediate FRAMESET parent.
  87. "_top"    : To load the link into the top body of the window.
  88.  
  89. You can also set a custom frame name, such as "myframe1".
  90.  
  91. With the "overimg" parameter you can specify the name of an image that will
  92. be painted over the applet. The best options are transparent GIF images.
  93. NOTE: Animated GIF images are supported, but will be displayed as animated
  94. only on latest browsers (Netscape 4 and Explorer 4 or newer).
  95. With "overimgX" and "overimgY" you can center the image over the applet area.
  96.  
  97. Changing the width and height of the applet will make the visible area of
  98. the bumpmap larger. You can set a width and height that are smaller than
  99. the picture to display, however we recommend that you set the applet width
  100. and height at the same size as the bump map image. 
  101.  
  102. If res=1, remember to place the exact size of image in "width" and "height"
  103. tags. If res=2, place double values, if res=3 place triple values etc.
  104. (In fact, res is a sort of zoomer).
  105.  
  106. The "picture" param is the filename of the picture to display. Make sure that
  107. this picture is available, or the applet will not work. Remember that using
  108. the correct upper and lower case is very important, or the applet will not
  109. run on non-P.C. machines. Example: Symb256.jpg should be written exactly as
  110. it appears, NOT SYMB256.JPG nor sYmB256.jPG.
  111.  
  112. The "bump" parameter decides if you want to use a separate bump-image
  113.  or if you want to calculate it from the screen picture. The latter is 
  114. recommended since it takes up less bandwidth, and the calculated bump-image
  115.  is run through some advanced filters to make it look realistic. Simply set
  116.  this parameter to "NO", if you want to use a calculated image, or to the 
  117. filename of the bump-image if you want to use that option.
  118.  
  119. Example: SymbBump.jpg or whatever your bump-image is called.
  120.  
  121. The "bump_height" parameter controls the height of the bump. If set high, 
  122. the shadow will be cast so that it appears to be higher bumps in the picture.
  123.  
  124. The "angle_x" parameter controls the movement of the lightsource in the
  125. horizontal direction. A higher value will make the lightsource go faster per
  126. frame horizontally.
  127.  
  128. The "angle_y" parameter controls the movement of the lightsource in the
  129. vertical direction. A higher value will make the lightsource go faster per
  130. frame vertically.
  131.  
  132. The "lightsize" param controls the size of the lightsource, ranging from 3 to
  133. whatever you would like. The size is calculated as 2^n, where n stands for the
  134. lightsize.
  135.  
  136. A "lightsize" of 9 would give a lightsize that is 512x512 pixels in size.
  137. The minimum lightsize is 8x8. There is no maximum limit, but due to memory
  138. aspects, the lightsize shouldn't exceed 512x512 pixels (9).
  139.  
  140. With "lightpower" you can choose a light intensity from 1 to 100.
  141. With lightmin and lightmax parameters, you can choose darker and lighter
  142. tolerances between 1 and 511.
  143.  
  144. The best test of this effect is with mouse movements, with the
  145. feature of interactive placement of the light enabled. Usually the light is
  146. moved around the image automatically, but if you set the "interactive" 
  147. parameter to YES, you can move the light with the mouse when it is over the
  148.  applet area. The automatic movements will restart after 2 seconds of no 
  149. user intervention. If you set to "NO", the user interaction option will be
  150. disabled.
  151.